home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / bench.man < prev    next >
Encoding:
Text File  |  1990-03-21  |  4.6 KB  |  135 lines
  1.  
  2.  
  3.  
  4. BENCH                     User Commands                     BENCH
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      bench  -  Benchmark  harness   that   coordinates   multiple
  12.      processes
  13.  
  14. SSYYNNOOPPSSIISS
  15.      bbeenncchh [_o_p_t_i_o_n_s] --cc _c_o_m_m_a_n_d
  16.      bbeenncchh --MM [_o_p_t_i_o_n_s]
  17.  
  18. OOPPTTIIOONNSS
  19.      --MM _n_u_m_C_l_i_e_n_t_s Run as master of the number of  clients  indi-
  20.                    cated.   The  master  bench  process should be
  21.                    started before any slaves.
  22.  
  23.      --SS            Run as a slave.  Use --cc to specify a  command.
  24.                    The  slave  process  will wait until all other
  25.                    slaves have registered with the master  before
  26.                    executing their benchmark.
  27.  
  28.      --cc _c_o_m_m_a_n_d _a_r_g_s ...
  29.                    Follow this with  the  command  to  benchmark.
  30.                    Execution  search  paths  are  not used (yet).
  31.                    The command can be followed with any  required
  32.                    arguments.
  33.  
  34.      --pp            Name of the pseudo-device used  for  coordina-
  35.                    tion.
  36.  
  37.      --oo _o_u_t_f_i_l_e    Output file in which execution statistics  are
  38.                    placed.
  39.  
  40.      --ff            Flush the file system cache  before  executing
  41.                    the benchmark.
  42.  
  43.      --xx            Disable all system  tracing  before  executing
  44.                    the benchmark.
  45.  
  46.      --hh            Enable taking of RPC timing histograms.   This
  47.                    is ok with -x.
  48.  
  49.      --dd            Don't sync the file system cache at the end of
  50.                    the  benchmark.   Normally  this is done after
  51.                    the benchmark completes and  before  the  file
  52.                    system I/O statistics are taken.
  53.  
  54.      --ss            Use  signals  instead  of  pseudo-devices  for
  55.                    rendez-vous.
  56.  
  57.      --PP _s_e_c_o_n_d_s    Pause for  some  seconds  before  getting  the
  58.                    final  statistics.  Only applies to the master
  59.                    bench process.
  60.  
  61.  
  62.  
  63. Sprite v.1.0        Printed:  March 21, 1990                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. BENCH                     User Commands                     BENCH
  71.  
  72.  
  73.  
  74.      --ww            Causes the master process to wait for  a  USR1
  75.                    signal  before  it  allows the slaves to begin
  76.                    running.  This option must be used with the -_M
  77.                    option, and cannot be used with the -_s option.
  78.  
  79. _________________________________________________________________
  80.  
  81.  
  82. DDEESSCCRRIIPPTTIIOONN
  83.      Bench is a harness for other programs that executes them and
  84.      takes  system  statistics.  The command to benchmark follows
  85.      the --cc option.  Currently bench does not used the  execution
  86.      search  path,  so  the  command  has to be a valid pathname.
  87.      (This should be fixed!) In its simplest form (no --SS  or  --MM)
  88.      bench  executes  a  single  process  and generates output to
  89.      ``bench.out'' or to the file specified  by  the  -o  option.
  90.      The  default  behavior  is  that  the execution time and CPU
  91.      utilization are recorded after the benchmarked process  com-
  92.      pletes,  then the file system cache is written back and file
  93.      system statistics are recorded.  The file system  cache  can
  94.      be  flushed  before  the benchmark using the --ff option.  The
  95.      cache write-back at the end of the run can be disabled  with
  96.      the --dd option.  The --xx option turns off various kernel trac-
  97.      ing that can slow down execution.
  98.  
  99.      Multiple processes can be coordinated using the  --MM  and  --SS
  100.      options.   First  a master bench process is started with the
  101.      --MM option.  This option is followed by an integer that indi-
  102.      cates  the  number  of slaves to expect.  The master process
  103.      creates a pseudo-device that will be used to coordinate  the
  104.      slaves.   Each  slave  benchmark  is  started  using  the --SS
  105.      option.  The slaves contact the master, and after  they  all
  106.      make contact the master lets them proceed.  The master bench
  107.      process also takes system statistics during the execution of
  108.      all  the  slaves.  It is generally run on the file server in
  109.      order to measure the load presented  by  the  slaves.   Note
  110.      that the master doesn't run a command itself, so no --cc argu-
  111.      ment is needed with --MM.
  112.  
  113. KKEEYYWWOORRDDSS
  114.      benchmark, statistics, timing
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131. Sprite v.1.0        Printed:  March 21, 1990                    2
  132.  
  133.  
  134.  
  135.